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Welcome to Issue 22 of The MagPi magazine. 


We kick off this month's issue with an article on solar tracking. Nathan and Nicholas introduce their 
amazing project, the ‘Reflective Solar Tracker’, a solar cell with the brains of a Raspberry Pi, capable of 
chasing the sun to improve energy capture by up to 140%! 


Andy Baker returns following his successful quad-copter series and this time he is featuring his 
intelligent night light. Andy describes building this project to reassure his son at night and banish those 
‘under-bed monsters’. It's a great mix of both the PiBow case and PiGlow add on-board. 


Following its recent success on Kickstarter we examine the Laika Explorer, a digital Input/Output board 
for the Raspberry Pi with the genius additions of USB and expansion ports. 


We welcome back Richard Wenner for his second article for The MagPi, where he continues his tutorial 
on using SQL by explaining how to insert and view stored data. Another welcome return is Philip Munts 
where he describes how to interface the Raspberry Pi to LEGO® Power Function motors. We also have 
more upcoming Raspberry Pi events from around the world and more book reviews to sink your teeth 
into. 


To finish up, we go out with a bang with three great articles. There is a home automation tutorial on 
controlling your garage door over the internet, we show you how to remotely program your Raspberry Pi 
using the superb Wyliodrin platform and finally we show you how to control Input/Output devices using 
scratch. What more Raspberry Pi themed goodness could you possibly want? 


To follow our progress you can like us on Facebook | — 
at http://www.facebook.com/MagPiMagazine to x 
keep up to date and give us more of your valued 
feedback. 


Pate 


Chief Editor of The MagPi 

The MagPi Team 

Ash Stone - Chief Editor / Administration Colin Deady - Layout / Testing / Proof Reading 

Les Pounder - Issue Editor Age-Jan (John) Stap - Layout 

W.H. Bell - Layout / Administration Sai Yamanoor - Testing 

Bryan Butler - Page Design / Graphics Claire Price - Layout 

lan McAlpine - Layout / Proof Reading Shelton Caruthers - Proof Reading 

Matt Judge - Website / Administration Nigel Curtis - Proof Reading 

Aaron Shaw - Layout Paul Carpenter - Testing 

Nick Hitch - Admin James Nelson - Proof Reading 


ASTRONOMICAL TRACKING 
Reflective solar tracking control system 


NIGHTLIGHT 
Keeping night-time monsters away with PiGlow 


LAIKA™ 
Part 1: Introducing Laika Explorer and digital output electronics 


MUNTS I/O EXPANSION BOARD 
Part 3: LEGO® interfacing with an ARM Cortex-MO microcontroller 


HOME AUTOMATION 
Controlling your garage door over the internet with the Raspberry Pi 


DATABASE BOOTCAMP 
Part 2: Inserting and viewing stored data 


THIS MONTH'S EVENTS GUIDE 
Torbay UK, CERN Switzerland, Quebec Canada, Wakefield UK, Beachwood USA 


WYLIODRIN 
Programming the Raspberry Pi from a web browser using a visual language 


1/0 EXPANSION WITH PYTHON AND SCRATCH 
Adding I/O devices to RpiScratchlO 


COMPETITION 
Win a bundle of Raspberry Pi accessories from PC Supplies Ltd 


BOOK REVIEWS 
Raspberry Pi User Guide Second Edition and Learning Python with Raspberry Pi 


FEEDBACK 
Have your say about The MagPi 
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control system 


Mechanical tracking systems are available to 
reposition a variety of devices including radio 
telescopes, antennae, and even _ television 
satellite dishes. These systems are large and 
often unaffordable for the small project 
developer. We are team members of a 
collaboration including two universities and a 
non-profit sustainable energy entity whose goal 
is to develop and commercialise a new solar 
energy collection device. 


This article will describe the new patent pending 
device called the Reflective Solar Tracker (RST) 
and will showcase the control systems function. 
The control systems' main hardware component 
is the Raspberry Pi, whose primary algorithm 
uses astronomical data to reposition the RST 
and collect voltage data for power and energy 
calculations. 


The Reflective Solar Tracker 


This device utilises both reflected sunlight via 
Mylar panels and a rotating base platform to 
increase the energy density impinging on 
commercially available solar panels. The extra 
sunlight from reflection saturates the individual 
crystalline solar cells while the rotating base 
ensures the saturation takes place for a longer 
portion of the day compared to conventional 


ASTRONOMICAL 


Advanced motor control 


Fra 3 at ea 


Reflective solar tracking 


stationary installations. The repositioning on the 
base platform is accomplished using a gear and 
worm screw turned by a low power DC motor 


controlled by the Raspberry Pi. The following 


describes the components for controlling a bi- 
directional DC motor, collecting voltage and 
current data from a solar panel installation, and 
the algorithm using astronomical data to 
guarantee the RST is always sun facing. 


Hardware description 


The hardware architecture for the Raspberry Pi 
control system functions with the use of products 
from http://www.adafruit.com specifically the 
DS1307 Real Time Clock, ADS1115 16-Bit 
ADC, L293D H-Bridge IC, IR home-position 
sensor and a 5200mAh power bank. The real- 
time clock is used to ensure the program 
executes daily at the proper time in case of 
power failure. To minimise the chance of failure, 
the Raspberry Pi is powered by a power bank, 
which is simultaneously being charged by a 5V 
1A power adapter. The motor is directly 
controlled by an H-Bridge that is interfaced with 
the Raspberry Pi GPIO pins. In addition to the H- 
Bridge for motor control, an IR home-position 
sensor is used to ensure the motor is returned to 
the proper location at the end of every cycle. The 
hardware architecture also includes an analog- 
to-digital converter that allows us to collect the 
solar panel output voltage data throughout the 
day. We also collect the voltage across a 10 
power resistor giving us the current. The 
connections of all of these components can be 
viewed in the provided block circuit diagram. 
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+e Oo ADS1115 walters 
| Divider 
| | Sv GRND SDA SCL SGAND SPA SEE AD AL AZAR BD 
oo — +L | 
—— — 5 ju — 
Ke) = Voltage ( 
™ alll 
Ke) °o | Home 
ioe i Position 
0 Ci 
| | | Out 
| o o . iSv 7 a 
| @ ° Cn = ue 23 . : 
fe Ke) iNT IN2 Vm Sv GRN OUT2I cw | 
R-Pi be | 
GPIO’s- L293D ouT}| ccw | Motor 


Tracking and data collecting 


algorithm 
Imports US Move to 
Naval Starting 
Observatory Position , 
Sun Azimuth Raspberry Pi 
Table and Sleep for Algorithm 


Begin 0.1 Hz 


Flow Chart 


30 minutes 
Data Collection 


RST CW 
to next 
position 


Calculate motor 
time durations 
and stores in 
array 


R : Yes 
Position 


CCW {East}? 


Sleep for 30 
minutes 


End 
Tracking 
and Data 


{East}? 
Collection Yes 


The primary algorithm, executed by a daily cron 
job, retrieves a local sun azimuth table 
containing the Sun's position in degrees relative 
to the eastern direction for the installation's 
geographic location in the current month. The 
hardware allows the motor to turn the base 
platform in both the clockwise (CW) and counter 
clockwise (CCW) directions. Beginning at 
6.00am, the algorithm calculates the starting 
direction in reference to East and moves the 
base platform CW or CCW to this position. 
Throughout the rest of the day, the motor is 
turned on for a specific interval every half hour 
and moves the base platform CW, in the 
direction of the sun's trajectory, to the next sun 
facing position. The following snippets of code, 
which utilise the NumPy library, include the 


readDayData() function that calculates the 
Specific time durations from the imported sun 
azimuth tables. The durations are stored in the 
motor_time|[] array. 


Once the algorithm reaches the end of the 
imported file, the RST rotates CCW back to the 
home position so it is facing east the next day. 
For our data logging function, we used some of 


the code from the Adafruit ADS1x15 class 
combined with the Python threading class. The 
method itself is written as a thread that is kicked 
off in the main method. Once executed, the 
thread will open a new text file titled with the 
current date. Inside the file, the thread will log 
and timestamp data from inputs A1 and A2 every 
10 seconds (0.1 Hz) until the daily tracking 
function ends and the thread stops. 


import time, subprocess, threading, datetime, Logging 
import RP1.GPIO as GPIO 

import numpy as np 

from Adafru1t_ADS1x15 import ADS1x15 


# GPIO setup would go here 


#Returns the 3 Letter month abbreviation of current month 
def getMonth(): 
temp = subprocess.Popen(["date"]|, stdout=subprocess.PIPE) 
date_string = temp.communicate()[Q] 
t1, month, t2= date_string.splitC' ',2) 
return month 


month_str = getMonthC) 
filepath = '/home/p1/RST/Months/' + month_str + '.txt' 
rawData = np.Lloadtxt(filepath, dtype=Cstr, float), usecols=(@,2)) 


motor_const = 0.462 # Units of deg/sec based upon speed of motor 


angle_deg = np.zerosCCLenCrawData),1), dtype=C(float)) 
motor_dir = np.zerosCClenCrawData),1), dtype=Cint)) 
motor_time = np.zerosCClenCrawData),1), dtype=Cint)) 


def readDayData(): 
z= Q 
whileCz < LenCrawData)): 
Loop_time[z,0] = tntCconvTimeSecCrawData[z,Q@])) 


Lit 4 s= Oe 
1fCfloatCrawData[z,1]) <= 90): 
angle_deg[z,0] = 90 - floatCrawData[z,1]) 
motor_dir[z,Q] = -1 
motor_time[z,@] = angle_deg[z,Q@]|/motor_const 
else: 
angle_deg[z,Q | floatCrawData[z,1]) - 90 
motor_dir[z,Q] = 1 
motor_time[z,@] = angle_deg[z,Q@]|/motor_const 
else: 
angle_deg[z,0] = floatCrawData[z,1]) - floatCrawData[z-1,1]) 
motor_dir[z,Q]| 1 
motor_time[z,@] = angle_deg[z,Q@]|/motor_const 
Z+= 1 


#Returns RST to home position 
def returnHome(): 
1fCGPIO.inputChomeSensor) == Q): 

Logging.infoCtimestampC) + ' 
GPIO.outputChbEnable, 1) 
GPIO.outputCmotorLED, 1) 
GPIO.outputCmotorCCW, 1) 
print "Returning home." 


class DataLoggingThread(threading. Thread): 
stop_data_log, delay): 
seLf).__i1nit__CseLf) 


def __init__Cself, threadID, 
super(DataLoggingThread, 
self.threadID = threadID 
self.delay = delay 


def runCself): 
ADS1015 = Ox@0 
adc = ADS1x15(Cic=ADS1015 ) 
Llogging.infoCtimestampC) + 
while not stop_data_log.isSetQ): 


: Returning to home position. ') 


: Running data logging thread." ) 


file = openC'/home/p1/RST/Data/" + today + '.txt','a') 
voltage = adc.readADCSingleEnded(1, 4096, 250) / 1000 
file.writeCtimestampC) + '\t" + strCvoltage)) 


current = 


file.closeC) 
time.slLeepCself.delay) 
Logging.infoCtimestampC) + 


Reflective solar tracking in the field 


Using the collected voltage and current data from 
the solar panels, we multiply the values together 
to get the power output of the panels. Integrating 
these power values in kilowatts over the total 
amount of hours of sunlight, gives you the total 
energy output in kilowatt-hours (kWh) of your 
installation. 


Our initial study compared the RST energy 
output versus a conventional stationary non- 
reflective installation. The plot on the right shows 
the power and energy comparison on a perfectly 
sunny day. 


We recently sent two RSTs to two locations in 
Uganda where one will be used to power an 
electric water pump at a rural parish school and 
the other to St. Joseph's Secondary School as a 
science experiment where the students will 


adc.readADCSingleEnded(2, 4096, 250)/ 1000 
file.writeC'\t' + strCcurrent) + '\n') 


: Exiting data logging thread." ) 
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collect data with the Raspberry Pi as a project 
and send us the files for our study. We also gave 
a keynote presentation at the 2013 Energy Path 
conference about the RST and the Raspberry Pi 
control system. Anyone with questions regarding 
the control system or project may contact us via 
email at nathan.williams2@scranton.edu and 
nicholas.truncale@scranton.edu. 


SKILL LEVEL : INTERMEDIATE 


A few weeks ago | bought a PiGlow on a whim from 
Pimoroni, but did nothing with it until a few days ago 
when my son woke up early in the darkness, having 
had a nasty dream. That made me wonder whether | 
could make an intelligent night-light for him, that’s 
dim when all’s well, but lights the room in a soothing 
glow if he wakes disturbed? 


Previously another project I'd started was a home 
alarm system; it reached proof of concept stage but 
then stalled. It used a Passive Infrared (PIR) motion 
detector: the perfect detector for under-bed monsters 
that go bump in the night. 


So, down to business: NightLight is powered from a 
Blackberry wall-wart charger. When the power is 
switched on, NightLight starts as part of the boot 
sequence and the LEDs twinkle. When it detects 
motion the style of LED lighting changes to a random 
choice of four, lasting for five seconds after motion is 
no longer detected. My chosen styles of flashing 
perhaps aren't really suitable for a night light for kids, 
but they provide good examples with which you or 
your kids can tinker and make your own. 


I’ve used one of my trimmed model A’s plus a custom 
PiBow to house the night light, but that’s not essential 
- a model A or B, with the PiGlow are all that’s 
needed - case selection is up to you. 


PiBow + PiGlow night light 


NIGHTLIGHT 
Keeping night-time monsters away 
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Andy Baker 


Guest Writer 


The PIR motion detector is available from Farnell / 
element14 at http://uk.farnell.com/jsp/search/product 
detail.jso?SKU=1373710. 


Attaching it was a bit tricky for me - the PiGlow 
makes all the GPIO pins inaccessible using a normal 
IDC connector. The solution depends on your 
soldering skills. | attached wires to the PIR detector - 
red (VDD) to pin 1 on the left; grey (OUTPUT) to pin 
2 in the center, and black (GND) to pin 3 on the right 
(see the top image on the next page). 


| fed those wires beneath the Raspberry Pi through 
the holes of the removed AV socket; depending on 
what case you have, you may be able to find easier 
holes to use. The red wire is soldered to GPIO pin 1, 
the black wire is soldered to GPIO pin 6 and the grey 
wire is soldered to GPIO pin 18 (see the bottom 
image on the next page). 


The movement detector could be replaced by a 
simple switch if you wish - simply connect one end of 
the switch to GPIO pin 1 (+3V3) and the other to 
GPIO pin 18 (GPIO input). Each press of the switch 
would trigger a new pattern exactly as though the 
motion had been detected. 


The code was a little more complicated than I'd 
anticipated; the eighteen PiGlow LEDs each have 
their own number for use by the code, but the 
numbers do not correspond to any of their colours or 
positions on the PiGlow board. | ended up writing 
some mapping code allowing much simpler code to 
select LED position / colours. That also then allowed 
the LED pattern code to be cleanly separated and 
simplified from the rest of the code allowing the 
various LED patterns to be extended / customized by 
you and your kids. 


The code Is described below and Is also available on 
GitHub as: 


https://github.com/PiStuffing/NiteLite 


from __future__ import division 
import signal 
import time 


from smbus import SMBus 


import RP1i.GPIO as GPIO 
import random 
import math 


# command register addresses for the SN3218 IC 
used in PiGlow 


CMD_ENABLE_OUTPUT = @x@Q 
CMD_ENABLE_LEDS = 0x13 
CMD_SET_PWM_VALUES = @x@1 
CMD_UPDATE = 0x16 


class PiGLow: 

12c_addr = 0x54 # fixed 12c address of SN3218 
IC 

bus = None 


def __init__Cself, 12c_bus=1): 
seLf.bus = SMBus(12c_bus ) 


# first we tell the SN3218 to enable output 
Cturn on) 


self .write_12cCCMD_ENABLE_OUTPUT, @x01) 


# then we ask it to enable each bank of LEDs 
(@-5, 6-11, and 12-17) 


seLf.write_i12cCCMD_ENABLE_LEDS, [Q@xFF, OxFF, 
OxFF |) 


def update_leds(self, values): 
self .write_12cCCMD_SET_PWM_VALUES, values) 
self .write_12cCCMD_UPDATE, @xFF) 


def write_i2c(Cself, reg_addr, value): 


# 1f a single value 1S provided then wrap it in 
a list so we can treat 


1f not i1sinstance(vaLue, List): 
value = [vaLue]; 


# write the data to the SN3218 


self .bus.write_12c_block_data(self.12c_addr, 
reg_addr, value) 


LED_ARM_TOP = @ 
LED_ARM_LEFT = 1 
LED_ARM_RIGHT = 2 


LED_COLOUR_RED = Q 
LED_COLOUR_ORANGE = 1 


LED_COLOUR_YELLOW = 2 
LED_COLOUR_GREEN = 3 
LED_COLOUR_BLUE = 4 

LED_COLOUR_WHITE = 5 


LED_PATTERN_TWINKLE = Q 
LED_PATTERN_GLOW = 1 
LED_PATTERN_SWELL = 2 
LED_PATTERN_DROPLET = 3 


LED_PATTERN_SNAKE = 4 
Set up the LED spiral arm / colour mappings: 


led_map = [] 
for arm in range(@,3): 
Led_map .append([ ]) 
for colour in range(Q,6): 
Led_map[arm].append(@) 


Led_mapLLED_ARM_TOP]LLED_COLOUR_RED] = 6 
Led_mapLLED_ARM_TOP]LLED_COLOUR_ORANGE] = 7 
Led_mapLLED_ARM_TOP]LLED_COLOUR_YELLOW] = 8 
Led_mapLLED_ARM_TOP]LLED_COLOUR_GREEN] = 5 
Led_mapLLED_ARM_TOP]LLED_COLOUR_BLUE] = 4 
Led_mapLLED_ARM_TOP]LLED_COLOUR_WHITE] = 9 
Led_mapLLED_ARM_LEFT ]LLED_COLOUR_RED] = @ 
Led_mapLLED_ARM_LEFT ] LLED_COLOUR_ORANGE] = 1 
Led_mapLLED_ARM_LEFT ]_LLED_COLOUR_YELLOW] = 2 
Led_mapLLED_ARM_LEFT ]LLED_COLOUR_GREEN] = 3 
Led_mapLLED_ARM_LEFT ]LLED_COLOUR_BLUE] = 14 
Led_mapLLED_ARM_LEFT ]LLED_COLOUR_WHITE] = 12 
Led_mapLLED_ARM_RIGHT ] LLED_COLOUR_RED] = 17 
Led_mapLLED_ARM_RIGHT ] LLED_COLOUR_ORANGE] = 16 
Led_mapLLED_ARM_RIGHT ] LLED_COLOUR_YELLOW] = 15 
Led_mapLLED_ARM_RIGHT ] LLED_COLOUR_GREEN] = 13 
Led_mapLLED_ARM_RIGHT ] LLED_COLOUR_BLUE] = 11 


led_map[LED_ARM_RIGHT][LED_COLOUR_WHITE] = 10 


Set up the LED number array: 


Leds = [] 
for led in range(O, 18): 
Leds .append(Q) 


Set up the LED brightness array: 
levels = [0, 1, 2, 4, 8, 16, 32, 64, 128] 
Set up the shutdown handler: 


def ShutdownHandler(Csignal, frame): 
global keep_Looping 
keep_Looping = False 


Set up the PIR movement detection callback: 


def PIRCalLbackCchannelL ): 
global motion_detected_time 
global Led_pattern 

global leds 


if Led_pattern == LED_PATTERN_TWINKLE: 
Led_pattern = random.randint (1, 4) 
motion_detected_time = time.timeC) 


Set up the PIR movement detection: 


GPIO_PIR = 18 

GPIO.setmodeCGPIO.BOARD) 
GPIO.setupCGPIO_PIR, GPIO.IN, GPIO.PUD_DOWN) 
GPIO.add_event_detectCGPIO_PIR, GPIO.RISING, 
PIRCaLlback, Q) 


Final steps of setup: 


Signal.signaLCsignal.SIGINT, ShutdownHandLer) 
piglow = P1iGLow(1) 

keep_Looping = True 

motion_detected_time = time.time() - 5.1 


while keep_Looping: 
Drop back to the default LED pattern: 


1f time.timeC) - motion_detected_time >= 5.0: 


Led_pattern = LED_PATTERN_TWINKLE 
twinkLe_count = @ 


TWINKLE: 0: Random LED lit with random, decaying 
brightness: 


tf Led_pattern == LED_PATTERN_TWINKLE: 


# dim all lit LEDs by one step in the Levels 
List 

# first find the index into the brightness list 
# This relies on the fact that values in the 
Levels 

# List are all 2An 


for led in range(O, 18): 
mant, Level = math.frexpCleds[ led] ) 
1f mant == 0.0: 
Level = Q 
1f level > Q 
Leds[ Led] = Levels[ Level - 1] 


On 


# Add a random LED every 1@ cycles with random 
brightness 


1f twinkle_count == @Q: 
LedsLrandom.randint(@, 17)] = 
LevelLs[random.randint(@, 8) ] 
twinkLe_count = CtwinkLe_count + 1) % 10 


piglow.update_lLeds(leds ) 
time.sLeepC@.1) 


GLOW: 1; All LEDs glow at a low level: 


elif led_pattern == LED_PATTERN_GLOW: 
for led in range(O, 18): 
Leds[ Led] = Levels[4] 
pigLow.update_lLeds(leds ) 


SWELL: 2; All LEDs brightness swelling up and 
down: 


elif Led_pattern == LED_PATTERN_SWELL: 
for level in range(@, 8): 
for led in range(O, 18): 
Leds[ Led] = Levels[ Level ] 
pigLow.update_lLeds(leds ) 
time.sLeepC@.1) 


for Level tn range(8, 0, -1) 
for led in range(O, 18): 
Leds[ Led] = Levels[ Level ] 
piglow.update_Leds(leds ) 
time.sLeepC@.1) 


DROPLET 3; Same colour sweeping up and down all 
the arms together at fixed brightness: 


elif Led_pattern == LED_PATTERN_DROPLET: 


for colour in range(@, 5): 
for arm in range, 3): 
Leds[ Led_map[arm]|[colour]] = 0x8 


pigLow.update_Leds(leds ) 
for arm in range(@,3): 
Leds[. Led_map[arm]|[colour]] = 0x00 


time.sLeep(@.1) 
for colour in range(5, @, -1): 
for arm in range(@,3): 
Leds[ Led_map[arm]|[colour]] = 0x8 


piglow.update_lLeds(leds) 
for arm in range(@,3): 


Leds[. Led_map[Larm]|[colour]] = 0x00 


time.sLeepC@.1) 


SNAKE: 4; Light each arm sequentially, with LED 
brightness brighter at center: 


elif Led_pattern == LED_PATTERN_SNAKE: 
for arm in range(@, 3): 
for colour in range (0, 5): 
Leds[. Led_map[Larm]|[colour]] = LevelLs[colour + 
1] 
pigLlow.update_Leds(leds) 
time.sLeepC@.1) 


for colour in range (5, @, -1): 
Leds[. Led_map[Larm]|[colour]] = LevelLs[colour + 


1] 


piglow.update_lLeds(leds ) 
time.sLeepC@.1) 
for colour in range(@, 6): 

Leds[. Led_map[arm]|[colour]] = 0x00 


# set all the LEDs to "off" when Ctrl+C 1s 
pressed before exiting 


for led in range(O, 18): 
Leds[ led] = Q@x@ 
piglow.update_Leds(leds ) 


For use as a night light, the last step is to run the 
code as part of the Raspberry Pi boot sequence so 
that it runs as soon as it’s turned on at the wall. This 
consists of a bash script. This script needs installing 
by saving it in /etc/init.d and typing: 


cd /etc/init.d 
sudo chmod 755 niteLited.sh 
sudo update-rc.d nitelited.sh defaults 


In addition to boot-time startup, you can also 
manually start and stop the night light by typing: 


sudo /etc/init.d/nitelited.sh start | stop 


Finally, there’s a video of it in operation on my site: 
http://blog.pistuffing.co.uk/?p=1748. It didn’t take 
long to make this fun little project. It is relatively easy 
to tinker with and exploring the different light patterns 
and how they work is a great way to learn Python. 


ADC-DAC PI 


2x 12 bit analogue to digital channels 
and 2x 12 bit digital to analogue 
channels. 


IO Pl 


32 digital input/output channels for 
your Raspberry Pi. Stack up to four IO 
Pi boards to give you 128 I/O channels. 


RIC Pi 


Real-time clock with battery backup 
and 5V I°C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


ADC P. 


8 channel analogue to digital converter. 
I?C address selection allows you to add 
up to 32 analogue channels to your 
Raspberry Pi. 


Com PI 


RS232 and 1-Wire® expansion board 
adds a serial port to your Raspberry Pi. 
Ideal for the Model A to enable 
headless communication. 


electronics 


Raspberry Pi® | Deluxe Starter Kit 
Starter Kits 


Everything but the screen 


http://shop.pimoroni.com 


Starter Kit £75 
Deluxe Starter Kit £120 


Pimoroni Gift Cards 
Choosing shiny things Is hard! 


http://shop.pimoroni.com 
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Learn to Solder 


Tools and Techniques for 
Assembling Electronics 


Maker 
PRESS 


Introducing Laika Pesiemee and 
digital output electronics - Part 1 


Introduction 


The Laika Explorer is an 1I/O (Input/Output) 
device for your Raspberry Pi. It has seven digital 
outputs, four digital inputs, two analogue inputs 
and a dual 1.3Amp motor driver with PWM 
speed control. The PCB has four on-board 
switches and seven LEDs and can be controlled 
with Scratch, Python or C. 
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Figure 1.0 - The Laika Explorer V1.20 


Okay, so another I/O device for the Raspberry 
Pi, albeit a very pretty one. Well, yes and no. The 
Laika system has two tricks up its sleeve: USB 
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and an expansion port. Let us start with the USB. 
This simply means that it connects to your 
Raspberry Pi (or Linux computing device) using 
a USB cable and so frees up the GPIO port for 
any other devices you may already own. 
secondly, the expansion port means that the 
core functionality can be expanded which is why 
Laika is a system - the Explorer is the first 
instalment of this system. Future plug-in modules 
will include high-current motor drives, |/O 
expansion, GPS, Bluetooth, Wi-fi, battery 
chargers, power supplies and many more. There 
is room for up to 32 modules, all of which can be 
controlled through the single USB connection. 


After a successful Kickstarter campaign which 
reached its goal back in August 2013, the Laika 
Explorer has been put through production and is 
available now for £34.99 (~US$47), or as an 
Inventor's Kit for £74.99 (~US$102), plus 
postage. This project is more than a PCB design 
though. Its goal is to embellish the hardware with 
tutorials, guides, lesson plans, schemes of work 
and example applications. There is much to do 
but you can see the current state of this work on 
the project's website at: htto:/Awww.project- 
laika.com. 


Start exploring 


The idea behind Laika is to promote users 
getting hands-on with the hardware and 
electronics. This can be daunting at first with no 
background knowledge, but | am going to show 
you how easy this can be. If any of the terms in 
the opening paragraph confused you then don't 
worry: after following these tutorials you will have 
a good enough understanding of the technology 
to start thinking about designing your own 
wonderful projects. 


Inputs and outputs 


Hold this thought in your head: all a computer is, 
in very simple terms, is a device that takes a set 
of inputs, does something with them, and outputs 
something useful. What the computer does is 
controlled by a set of instructions - a computer 
program. Now think of Laika as a way of 
providing an easier way for you to interface your 
computer program to those inputs and outputs, 
or to put it another way, to interface to the real 
world. You are the most important part in this 
system because it is you who writes the 
instructions to control the I/O - to control the 
world! 


Let's get digital 


Digital means that data is represented in discrete 
values and for computers this is usually just two 
values. YOu may recognise this as_ binary 
(systems do exist with more than two states: 
trinary for example has three states) and you 
may think of these two states as 'on' and 'off’, 
‘high’ and ‘low' or ‘one’ and ‘zero’: all are correct 
but remember that ones and Zeros is how data is 
stored. For example, 'on' could be a state 
represented by a'1' as you might think, but could 
equally be represented by '0' if the hardware 
turns ‘on’ when it receives a '0". 


So when you are controlling the digital outputs 
you have two choices: 1 or 0. On the Explorer 
there are seven digital outputs. You might think 
of these outputs as being able to drive high and 


low, that is, when you turn off an output it goes to 
OV and when you turn on an output it goes to 
some higher voltage. The former is true, but in 
the case of the Explorer, the latter is not. 
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Figure 2.0 - Digital outputs on the Explorer 


The reason for this is that we want to able to do 
something useful with our outputs and this 
usually means consuming a certain amount of 
current. Say for instance, you want to drive a 
relay which may take 50mA, then a typical 
microcontroller output is not capable of this and 
trying to accomplish it will likely damage the 
device. That's why you need to heed all the 
warnings about protecting the GPIO port on your 
Raspberry Pi from over-current. Most add-on 
GPIO modules promote the fact that they use 
buffering to prevent this damage. 


To give us the extra power capability, a buffer is 
also used: you can see it in the picture above 
labelled as IC3. This device gives us over 
100mA per channel which is plenty to drive most 
relays and even motors. There is a drawback: 
each digital output is only able to sink current. 
That means that when it is turned on, the output 
goes to OV (a nice example of an 'on' being a 
‘low’, not ‘high'). This means that your device, 
LED, relay or motor, will always have positive + 
connected, and the negative is what is switched. 
See Figure 3.0 below. 


Load 


Figure 3.0 - Transistor switch 


GND 
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The symbol with an arrow is a transistor and you 
can think of it as a switch, switching the OV (or 
ground/GND) to the load. The small circle is 
effectively the output pin which makes you see 
that it is not possible to drive the output high: only 
OV and open/disconnected. It is possible to 
design circuitry to drive high as well as low but 
these come with cost implications. 


Now that you have a better understanding of this 
port it is time to do something useful with it. 


Scratch to digital outputs 


Each output pin is labelled DO to D6. These are 
the seven digital outputs and you can control 
these individually or by writing a single byte to 
update the whole port in one go. Each output pin 
has associated with it an on-board LED which 
means that you can test your output control 
without any other hardware. 


In Scratch you can control the digital output port 
using binary, integer or hexadecimal. We will use 
binary as that is the raw form and is the right 
place to start if you are learning about 
computing. 


To set the digital outputs in binary do the 
following: 


Click on ‘Variable’ in the top left corner of 
Scratch. 

Select ‘Make a variable’. 

Make the variable name 1k_exp_dout_bin 
(this must be an exact match). 


You should now see that Scratch has 
automatically produced the following commands: 


Figure 4.0 - Setting up the digital output variable 
in Scratch 


Move the ‘set’ command into the script area and 
set the ‘to value to ‘0000111’. 
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Figure 5.0 - Writing to the digital outputs in 
Scratch 


Click the Green flag and voila, the LEDs indicate 
the binary value. 
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Figure 6.0 - LED’ S 


Here is an example of Laika controlling a /7- 
segment display with the digital outputs. See 
http://www.project-laika.com for a tutorial. 
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Figure 7.0 - 7-segment control 


You may have noticed in Figure 2.0 that the 
digital output pins are accompanied by another 
pin labelled as 'Vin'. This stands for Voltage In 
and is connected to the input power of the 
Explorer board. So if you are using a 5V power 
adaptor to power your Explorer then Vin will also 


be 5V. The Explorer is specified to operate 
between 4.6V and 10.8V, so you need to bear 
this in mind when connecting your load to the 
Output pins. 


EMF 


No not the 1990's band with a hit song 
Unbelievable, but rather Electromotive Force - 
much more interesting | am sure you'll agree. 
You don't need to fully understand EMF, unless 
you have a physics exam coming up, but you 
should be aware of it. Remember this: pass an 
electric current through a piece of wire and you'll 
produce a magnetic field around it. When you 
remove the power that magnetic field collapses 
and causes some portion of energy to return to 
the source- this is Known as back-EMF or 
counter-EMF, and can damage _ sensitive 
electronic components. 


lf all you are driving is LEDs then you can forget 
about back-EMF as there aren't enough coils of 
wire to produce enough energy to cause any 
damage- it is still there but is negligible. If, on the 
other hand, you are driving a motor or a relay 
which are effectively inductors made from coils of 
fine wire, then there will be a significant amount 
of back-EMF. So the amount of back-EMF is 
affected by the length of wire used? Yes! That is 
why you should always keep any wires carrying 
significant power as short as possible. Don't 
bundle all wires together, try not to coil them up 
too much as this may cause cross-talk where 
one wire induces interference on another and 
keep your signal wires away from your power 
wires and electrically noisy devices like motors. 
This is a very deep subject but as long as you 
have consideration you should be fine. 


To protect the Explorer outputs from damage by 
back-EMF, each output is protected by a diode 
which allows the nasty EMF current to be 
dissipated through the diode and away from our 
delicate transistors. To take advantage of this 
feature you need to connect all loads that are 
controlled by the digital output pins to the Vin pin 
as this completes the circuit. You may never 


consider using anything other than Vin as your 
power source for the digital outputs, but you 
could run some LEDs from another power source 
if you wanted. You could run a motor or inductor 
too but you would have to provide your own 
diode protection in this case. Figure 8.0 shows 
an example of how this diode is wired. 
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Figure 8.0 - Wiring the diode 
Next time 


In this article we have covered the digital outputs 
which means you can now drive relays, motors, 
LEDs, solenoids or whatever can be driven 
within the parameters. Next time we will look at 
the inputs, both analogue and digital. This leads 
us to creating a closed-loop system where the 
Output is automatically controlled by values 
sensed on the inputs, thus opening up all sorts of 
possibilities. 


In the meantime please see the website for more 
information: 


http://www.project-laika.com - main site 


http://www.project-laika.com/about-laika 
- introduction to the Laika platform 


http://www. project-laika.com/tutorials-index 
- a list of various tutorials offered for Laika 


http://www.project-laika.com/T utorials/laika- 
installation - installation instructions 


Introducing Laika Explorer and digital output 
electronics 
Analogue and digital inputs 


Motor driving with PWM 
Applications- bringing it all together 
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LEGO® Power Functions 


remote control 


Introduction 


In The MagPi Issue #17, | introduced how to use 
the LPC1114 analogue inputs for sensing the 
position of an analogue joystick. In this article | 
will show how to control the LEGO® Power 
Functions motor with the LPC1114 I/O 
Processor and how to apply the joystick for 
controlling a LEGO® RPV (Remotely Piloted 
Vehicle). 


LEGO® Power Functions remote 
control 


LEGO® Power Functions is a system of motors 
and sensors for the LEGO® system. They can 
be used with either the traditional LEGO® 
blocks, or with the newer Technics mechanical 
components. The motors and sensors can be 
purchased separately or as part of a set, such as 
the LEGO® City train set #7938. 


The Remote Control IR Receiver #8884 decodes 
infrared remote control messages in a special 
coding and sets the speed or position of up to 
two motors. The receiver is designed to work 
with the Remote Control #8879. We will be 
synthesising the infrared messages~ with 


firmware in the LPC1114 I/O Processor to 
control the IR receiver from the Raspberry Pi 
instead. 


Figure 1 - Some LEGO® Power Functions 
components left to right: Motors, IR Receiver and 
Battery Box. 


Infrared protocol 


The IR receiver expects a fairly complex 
protocol. Fortunately LEGO® has published the 
protocol specification, which can be downloaded 
from the web page for the #8884 IR receiver. | 
have added a service to the LPC 1114 SPI Agent 
Firmware that encodes messages for the IR 
receiver. 


Setting up to generate LEGO® Power Functions 
RC messages Is easy. First, configure one of the 
LPC1114 GPIO pins as an output, with the 


SPIAGENT_CMD_CONFIGURE_GPIO_OUTPUT 


service. Be sure to initialize the output state to 
OFF by setting the data field to zero. 


Next, generate a message with the 
SPIAGENT_CMD_PUT_LEGORC 


service. The data field must be loaded with 
parameters encoded as follows: 


Bits 0-7 Speed: Q-7 

Bits 8-15 Direction: @=Reverse 1=Forward 

Bits 16-23 Motor: Q=ALL stop, 1=Motor A, 
2=Motor B 

Bits 24-31 Channel: 1-4 


see the LPC1114 I/O Processor Expansion 
Board User Guide  (http://munts.com/rpi- 
loc1 114/doc/UserGuide.pdf) for more 
information about the SPI Agent Firmware API 
(Application Programming — Interface). The 
available services are described in detail there. 


Infrared emitter circuit 


To transmit commands to the IR receiver, you 
will need to drive an infrared LED (more properly: 
infrared emitter) from one of the LPC1114 GPIO 
pins. The GPIO pins can only supply 4 mA of 
current, which is too little to drive an infrared 
emitter efficiently. Infrared emitters can 
commonly be driven at 100 mA or more. In order 
to boost the output current we will use the 
ULN2003A, a current driver IC that has been 
around for many years but is still highly useful for 
this purpose. 


The ULN2003A contains 7 amplifiers, or current 
boosters, each of which can sink 500 mA 


continuously, or even more for short pulses. 
Since the ULN2003A is a current sink (pull to 
ground) device, the cathode (minus) pin of the 
infrared emitter is connected to the ULN2003A 
output through a current limiting resistor, and the 
anode (plus) pin is connected to +5V. (Do not 
attempt to connect the infrared emitter to +3.3V; 
the voltage regulator on the Raspberry Pi cannot 
Supply enough current.) See Figure 2 for the 
infrared emitter circuit. 


+5V 


Figure 2 - Infrared emitter connection 


A wide variety of infrared emitters are available, 
at either 850 or 940 nm wavelengths. Both 
wavelengths seem to work with the #8884 IR 
Receiver, but | infer from the colour of the filter 
that it may be optimized for 940 nm. Figure 3 
shows a couple of emitters | tried. 
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Figure 3 - Infrared Emitters - Top: SFH4545, 
Bottom: SFH4233 


The SFH4545 (Digi-Key part number 475-2919- 
ND) is a 940 nm emitter rated at 100 mA current 
(pulse), and is representative of what you will 
find at Radio Shack or other hobbyist sources. 
This class of device should have a 33Q current 
limiting resistor. 


The SFH4233 (Digi-Key part number 475-2910- 
1-ND) is a very high power 940 nm emitter rated 
at 1 A current (pulse). This device should have a 
3.3Q current limiting resistor. 


Warning: The combination of the 
ULN2003A, SFH4233 and 3.30 resistor are 
capable of generating serious heat if the 
GPIO pin is left in the ON state. They are 
capable of melting a solderless breadboard! 
(Examine the top of Figure 5 closely for an 
example!) 


Pythons test program 

Once the hardware is put together, you can test 
your setup with the Python3 test program 
test_Legorc.py. It accepts an optional host 
name parameter and then 4 numbers (channel, 
motor, direction and speed). If the motor, 
direction and speed are all zero, a panic stop is 
issued (both motors are stopped immediately). 
Show program usage 


./test_lLegorc.py 


Raspberry Pi LPC1114 I/O Processor Expansion 
Board LEGO Power Functions RC Test 


Usage: ./test_Legorc.py Lhostname] <channel:1- 


4> <motor:0-2> <forward:Q0-1> <speed:Q-7> 
Channel 1, motor 1, forward, speed 1 
./test_legorc.py Localhost 1111 
Panic Stop 


./test_legorc.py Localhost 1 0 @ @ 


Python3 remotely piloted vehicle 


For experimentation my son and | constructed a 
skid steer remote vehicle and wrote a Python 
program to control it using the analogue joystick. 
A skid steer vehicle has independent motors 
driving wheels or tracks on either side of the 
vehicle. Steering is accomplished by driving 
each side at a different speed and/or direction, 
as shown in Figure 4. 


Figure 4 - Pythons remotely piloted vehicle 


The Pythons RPV program 
test_Legorc_rpv.py uses the analog joystick 
setup from the previous installment in The MagPI 
#17. The ULN2003A and the SFH4233 infrared 
emitter have been added to the breadboard, as 
illustrated in Figure 5. 


Unlike test_Legorc.py, which calls C functions 
in Libspiagent.so, test_Legorc_rpv.py 
uses XML-RPC. This simplifies the Python code 
somewhat. 


Implementing skid steering in software from a 
single joystick proved tricky. A certain amount of 
heuristics (fudge factors) were required. 


Useable range for the IR remote control system 
will vary depending upon the ambient 
environment and the placement of the infrared 
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emitter. In my office, with a low white ceiling and 
using the high power SFH4233, range and 
coverage are very good as the IR reflects well off 
the ceiling. At the Helsingborg Raspberry Jam, 
in an office building foyer with very high ceilings 
that were dull gray, range was only a few meters 
with reflected signal. In such circumstances, 
placing the emitter for line of — sight 
communications instead of relying on reflections 
would help. 
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ULN2003 datasheet: Figure 5 - Joystick and IR Emitter Hookup 


Parallax 2-axis joystick information: LEGO® is a trademark of the LEGO Group of companies 
which does not sponsor, authorize or endorse this site 
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Interfacing with a relay 


WeblOP!I 


SKILL LEVEL : BEGINNER 


Introduction 


Have you ever opened your garage door, but 
then forgot to shut it later? In this article | will 
show you how to open and close your garage 
door over the internet, using a Raspberry Pi, a 
relay and WeblOPi. There is even a webcam 
attached to the Raspberry Pi, such that you can 
visually confirm that the door is really closed. 


Before you start 


These instructions assume that sshd is running 
on Raspbian. For older images, you can enable 
sshd using: 


sudo raspi-config 
and then enable SSH via Advanced Options. 
Parts needed 


You will need the following parts: 

¢ Raspberry Pi Model B 

° 12V relay 

¢ Adafruit Small-Size Perma-Proto breadboard 
¢ female jumper wires 

¢ regular hookup wire 

¢ 1N4001 diode 

¢ webcam that does not require a powered hub 


Garage door automation with 


Lewis Callaway 


Guest Writer 


The tools needed are a_ soldering iron, 
screwdriver, wire strippers and wire cutters. 


[Ed: Check the specification of your garage door 
and choose a relay that is appropriate for the 
voltage and current. It may be necessary to use 
a transistor/FET driver with the relay. ] 


Installing WeblOPi 


The framework we are going to use to control the 
relay is WeblOPi. [Ed: Web/OPi was_ first 
introduced in issues 9 and 10 of The MagPi.] To 
install this package, from the command line 
enter: 


wget http://web1op1 .googLecode. com/f1iles/WebI0 
Pi-0.6.0.tar.gz 

tar xvzf WebIOP1-@.6.0.tar.gz 

cd WebIOP1-0.6.@ 

sudo ./setup.sh 


Then configure WeblOPi to start when the 
Raspberry Pi boots, and then reboot: 


cd 
sudo update-rc.d webiopi defaults 
sudo reboot 


Wait for a minute after rebooting the Raspberry 
Pi. Then open a web browser and enter the IP 
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address of the Raspberry Pi followed by the port 
number of WeblOPi which is 8000, e.g. 
http://192.168.2.15:8000. 


When connecting to the Raspberry Pi using the 
web browser, a login screen will appear. 


| Authentication Required 


The server http://192.168.2.15:3000 requires a username and 
password, The server says: webiopi. 


User Name: | 


Password: 


| 
Log In Cancel 


The default login is: 


User Name: webiop1 
Password: raspberry 


The next screen shows a virtual representation of 
the Raspberry Pi's GPIO pins. The relay can be 
connected between a ground pin and a GPIO 
pin. To activate the relay, click on _ the 
corresponding button to set it as an OUTput 
instead of an INput. Now when the GPIO pin is 
selected, it will send a voltage to the relay 
connected to it. 
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Configuration 


To make the interface cleaner, WeblOPi can be 
configured to offer one button instead of many 
small ones. 


Create folders to store the files: 


mkdir -p garage/html 
mkdir garage/python 


The next step is to create a python file that helps 
the HTML file control the garage door opener. 


nano garage/python/script.py 


Now copy the code below into the new file. 


import webiop1 
GPIO = webiop1.GPIO 
Garage = 17 # GPIO pin using BCM numbering 
# setup function 1S automatically called at 
# WebIOP1 startup 
def setup(): 
# set the GPIO used by the light to output 
GPIO.setFunctionCGarage, GPIO.OUT) 
# Loop function, repeatedly called by WebIOP1 
def Loop(): 
# gives CPU some time before Looping again 
webiop1.sleep(1) 


Then press CRTL-X and then Y to save the file. 
WeblOPi will access this python script using an 
HTML page that contains the single button. Use 
nano to create a new HTML file, 


nano garage/htmL/index.html1 


Then copy the HTML from the next page of this 
article into the file and save it. 


<! DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transittonal//EN"> 


<html> 
<head> 


<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 


<titlLe>Garage Control</title> 


<script type="text/javascript" src="/webiop1.js"></script> 


<script type="text/javascript"> 
webiopiC).readyCfunctioncd) { 


// Create a "Light" Labeled button for GPIO 17 
var button = webiopiC).createGPIOButton(17, "Garage" ); 


// Append button to HTML element with ID="controls" using jQuery 


$C"#controLls").append(button) ; 


// Refresh GPIO buttons 


// pass true to refresh repeatedly of false to refresh once 


webiop1iC).refreshGPIOCtrue) ; 
$); 
</script> 
<style type="text/css"> 
button { 
display: block; 
margin: 5px 5px 5px 5px; 
width: 128Q@px; 
height: 72Q@px; 
font-size: 1@Qpt; 
font-weight: bold; 
color: white; 


I 


#gp1017.LOW { 
background-color: Black; 


t 
#gpio17.HIGH { 


background-color: Yellow; 


} 
</style> 


</head> 
<body> 
<div id="controls" align="center"></div> 
</body> 
</html> 


To use the Python script and new HTML file, 
modify the WeblOPi configuration file: 


sudo nano /etc/webiopi/config 


Find the [SCRIPTS] section and add the 
following line: 


garage = /home/pi/garage/python/script.py 


Then find the [HTTP] line and add the following 


line: 
doc-root = /home/p1/garage/html 


Lastly, find the [REST] line and add the following 
lines: 


gpio-export = 17 
gp10-post-vaLlue = true 


gp10-post-functtion = false 


Then save the file and reboot the Raspberry PI: 
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sudo reboot 


Motion setup 


The motion package can be used with a 
webcam, to check the garage door's status. 
While this article uses a USB webcam, the 
Raspberry Pi camera can also be used. There 
are specific instructions for using the motion 
package with the Raspberry Pi camera at: 
http://ronrpi.wordpress.com/project-list/setting- 
up-wireless-motion-detect-cam/ 


To use UVC camera support, make sure the 
latest stable firmware is installed by updating the 
Raspbian installation: 


sudo apt-get update; sudo apt-get upgrade -y 
Then install the motion package: 

sudo apt-get install motion 
Next, open the configuration file in nano: 


sudo nano /etc/motion/motion. conf 


Change daemon off, to daemon on. This will 
Cause motion to run as a daemon process that 
runs in the background. The default resolution of 
320x240 is a reasonable choice. Change 
webcam_Localhost on to off. This allows the 
camera feed to be viewed from another device, 
instead of just from the Raspberry Pi. Now save 
the file. 


To simply the setup, motion can be configured to 
start when the Raspberry Pi boots by editing: 


sudo nano /etc/defauLt/mottion 
In this file change, 
start_motiton_daemon = no 


to: 


Start_motion_daemon = yes 


Then save the file and reboot the Raspberry PI: 


sudo reboot 


Now that motion has been configured, plug in a 
Debian Wheezy compatible webcam. The 
webcam should then stream video to your 
Raspberry Pi's IP Address followed by :8Q81. 


Hardware 


The hardware in this project consists of a relay 
that allows the Raspberry Pi to switch a garage 
door opener on or off. To hookup the relay to the 
garage door opener, a Perma-Proto PCB was 
used. Ihe relay was soldered directly to the 
Perma-Proto PCB, together with all the wires. To 
prevent an electrical short the bottom of the PCB 
was covered with electrical tape after the 
components were soldered on. A 1N4001 diode 
was placed across the relay coil pins, to avoid 
damaging the Raspberry Pi GPIO pin. This is 
not optional. If the diode is not used, it will 
eventually destroy the Raspberry Pi! 


Use the datasheet for your relay to determine the 
pinout. There is an example below of how a relay 
can be connected. In the example, the Raspberry 
Pi connects to the coil with a diode in between 
the control (red wire) and ground (black wire) 
pins. The garage door is connected to the 
normally open pin and relay switch pin (two grey 


wires). 
GPIO 17 
Ground 


To RasPI 


st] 


To Relay 
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The coil on the relay should be connected to 
Ground and GPIO 17 on the Raspberry Pi using 
the female jumper wires. 


Soldering the Board 


1. Cut and sirip the two female jumper wires in 
halt. 
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3. Next, solder the black female jumper wire to 
the coil on the relay and the red jumper wire to 
the coil on the relay. Then trim the excess wire 
from the bottom of the board. 


4. To prevent the Raspberry Pi from being 
damaged, a 1N4001 diode is needed between 
the ground and control pins on the relay. The 
silver band on the diode needs to be connected 
to the control wire. Do not connect it to the 
ground. 


5. Solder the wires that will connect to the garage 
door to the normally open pin and ground on the 
relay. Again, trim the excess wire after soldering. 


\@e@, t 
6: 
6 
" } 
@e:| 
=|@ 
1 | 


Ih < 
S¢e:, 
 ] 


Sé¢eee. | 
Jav = iJ 


2 @ 

"@ee ee 
“@OG*R aa = 
@ 5 ar ee 
Bye Pic  @ 

7. = —] be! 
Itt Reesces. 
i:@e@ e@eeeee 
/-8e@ S¢2@eee@ - 
|-e @ ®eeeee¢6- 
iid? if shhh eT oe 
o@ ne 
arte @e@ ®®eeee6 | 


6. Lastly, cover the bottom of the board with 


Once this is done, the PCB can be connected to 
the garage door opener. 


Garage door opener connection 


Be very careful when dealing with higher voltage 
circuits, such as a garage door opener. Before 
making any connections, make sure that the 
electrical power to the garage door is turned off. 
Then use a screwdriver to connect the wires 
from the relay to the garage door opener. If in 
doubt, consult the garage door opener manual, 
to check which wires to use. 


There is a video of the system working at: 
https://www.youtube.com/watch?v=3gIWNjPUQ 


ol 


Information on accessing the Raspberry Pi 
outside the private local area network is given at: 
http://www.wikihow.com/Set-Up-Port- 
Forwarding-on-a-Router 
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U PiS The all-in-one solution 
module 


A wealth of features in a single board: 
- UPS function with Li-Po battery 
- Versatile powering for RPi (7-18VDC) 
- Hardware ON/OFF switch for the RPi 
- Software-readable V/mA/°C sensors 
- Battery backed-up real-time clock 
- Timer controlled RPi ON/OFF 
- RS232 and USB interfaces 


- °C PiCO interface 

- 1-wire and iButton input 

- Basic I/O pin and relay outputs 

- XTEA-based encryption of user software 


available from distributors : 
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Inserting and viewing 


stored data 


In the article entitled DATABASE BOOTCAMP, 
way back in issue 8, on pages 26 to 28, | 
introduced you to (what | think) is the language 
most suitable for learning on computers and one 
rarely offered, the Stuctured Query Language or 
SQL. 


| showed you how to install MySQL, until now 
the most popular database available and how to 
view databases, how to view data, how to 
create a database and how to create a table. 


| promised you that the next time we would be 
looking at inserting data into a pre-populated 
table and how to sort and search by using 
logical expressions. | suggest that you read this 
previous article once more in order to refresh 
your memory. 


In this issue I'll introduce you to this essential 
next step. In the earlier article we created a 
table named birdtable and than used the 
command DESCRIBE birdtable to reveal the 
description of this table: 


Column Content Data-type 


id integer int 
text (max 25 chars) 


Text (max 30 chars) 
dob 


date 


Database Bootcamp 2 
Teach yourself MySQL 


I'll explain this table in conjunction with the next 
command, to shows you how to insert data: 


INSERT INTO 

birdtable Cfirst_name, town, dob,birds) 
values C"Fred", "Epping" ,19571225,3); 
Query OK, 1 row affected (2.53 sec) 


So let's now examine the INSERT INTO 
command that can be entered on a single line 
but it has been laid out here for more clarity. It 
should be clear to see if you execute a SELECT 
that the table called birdtable now has a row (or 
record) containing: 


Fred in first_name 

Epping in town 

19571225 in dob (date of birth) 
le 25th December 1957 and 

3 goes into birds 


Note the way data is entered. Text is 
surrounded by quotation marks, the date is 
entered in the yyyymmdd format although you 
could change this but for the moment we will 
use this format. The numbers (integers) are 
entered directly as numbers. Each value is 
separated by a comma. Also note that we put a 
semicolon (;) at the end of the command. This is 
what the table was programmed to accept in the 


CREATE TABLE command in Issue 8. 


Comparing the SQL command to the list of data 
entered to the table of columns may leave you 
confused: what is the "id" column for and why is it 
not populated? I'm glad you asked! 


Suffice it to say that we created a column "id" 
that will automatically increment each time a new 
entry is added to the table. This will result in the 
first row in the table having an id=1 , the second 
row id=2, the third row id=3, and so on. 


The column "id" is not something that we need to 
worry about after we create the table, as it is all 
automatically calculated within MySQL. 


Try adding a few more lines of data of your own. 
Top-tip: it is quicker to press the up arrow key in 
order to recall and edit the previous line and 
press enter again. This saves typing the whole 
line, particularly as the rest of the command 
remains unchanged. 


Also note that MySQL confirms each entry with a 
line about the number of rows affected. 


Confirm your table contains the values you have 
added by entering: 


SELECT * FROM birdtable; 


Two useful database functions are sorting and 
searching. Let us try some examples. 


Viewing the data in a sorted order by entering: 


SELECT * FROM birdtable 
ORDER BY first_name; 


To see everything sorted by first_name: 


SELECT * FROM birdtable 
ORDER BY birds DESC; 


To see the same list but this time by the 
descending number of birds. 


Viewing the data - searching 


In the SELECT FROM command we used the 
Asterisk (*) as a wild card meaning all records or 
a substitute for zero or more characters in a 
record. There are two other wild cards that we 
can use: the percent (%) symbol and the 
underscore (_). Where you can only use the 
asterisk as a wildcard (or truncation) in a full text 
search, the % (match zero or more characters) 
and _ (match exactly one character) are only 
applicable in LIKE-queries. 


The LIKE keyword tells MySQL that the named 
column must match the given pattern. In a 
database with a long text string for instance, we 
could write: 


SELECT text_string FROM database_name 
WHERE text_string LIKE "%Raspberry P1%"; 


We will touch on the LIKE command a little bit 
later. 


We will try these wildcards in the database by 
entering: 


SELECT * FROM birdtable 
WHERE Cfirst_name = "Fred" ); 


To see everything where the name Is Fred. 


SELECT * FROM birdtable 
WHERE Cfirst_name LIKE "Fr%"); 


SELECT * FROM birdtable 
WHERE Cfirst_name LIKE "Fr_d"); 


To catch many options (if they existed): Frad 
Frod Fred Frdd Fred Frfd Frzd etc. The 
underscore limits your search to just that 
character while the percentage replaces any 
number of characters. 


SELECT * FROM birdtable 
WHERE Cfirst_name like "%r%"); 


All first names with an r in them. 


as )) 


SELECT * FROM birdtable 
WHERE Cbirds >3); 


All records with more than three birds will show. 
Logical words in SQL commands 


Two logical words that can be included in SQL 
commands are AND and OR. AND means that 
both conditions of a statement must be met and 
OR Insists that either one or the other condition 
must be met. 


Try commands like: 


SELECT * FROM birdtable 
WHERE Cfirst_name like "%r%") 
AND birds >3; 


To find names with the letter r in them and birds 
greater than 3. 


OR means either condition needs to apply. Try 
commands like: 


SELECT * FROM birdtable 
WHERE Cfirst_name = "Fred") OR birds < 3; 


To find Freds or entries with birds less than 3. 


All this is nice but how about being more 
selective in choosing our parameters? 


In every example above we have printed out all 
of the fields for each selected record. We can be 
more selective by typing: 


SELECT town, dob from birdtable 
WHERE Cfirst_name like "%r%") 
AND bird > 3 ORDER BY bird; 


Notice here how the ORDER By option can be 
added to build even smarter SQL commands 
and to retrieve the data in the order we want. 


Conclusion 


There is a lot to be gained by testing these 
commands on your Raspberry Pi. Working in text 


mode as we have been doing in this article is a 
rapid way of learning, testing, building and 
repairing databases as well as being a 
fundamental computing skill. 


MySQL has always had a rather steep learning 
curve when you want to go from straight forward 
to complex SQL queries, especially when they 
involve joins. 


We are dealing with databases and can not 
afford to make mistakes. This adds to the 
pressure and manipulating these databases 
should therefore always be done on a copy, 
away from the real thing until we feel secure in 
doing what we want to do. 


There are many good books on the market that 
deal with SQL databases. One that comes to 
mind is the excellent work of Kevin Yank. Kevin 
has published a number of books through the 
SitePoint publisher. His line of approaching SQL 
almost makes the experience a gradual stepping 
up to the rank of intermediate SQL professional. 


His book is: PHP & MySQL: Novice to Ninja 5th 
edition (Build Your Own Database Driven Web 
Site Using PHP and MySQL). 
http://www.amazon.co.uk/Kevin- 
Yank/e/B0034Q3XD8/ 


The World Wide Web is also a good source of 
MySQL teachings and many of these texts will 
helo you in your efforts to conquer the SQL 
database. 


For example, w3schools.com host a PHP and 
MySQL Introduction: 
http://www.wsschools.com/Php/php_mysal_ intro 
asp 


The MySQL Reference Manual contains a 
tutorial and is available at: 
http://dev.mysql.com/doc/refman/5.5/en/tutorial.h 
tml 


A supporting video by the author is also available 
online: http://orOmpt.me 
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Want to keep up to date with all things Raspberry Pi in your area? 
Then this section of The MagPi is for you! We aim to list Raspberry Jam events in your area, providing 
you with a Raspberry Pi calendar for the month ahead. 


Are you in charge of running a Raspberry Pi event? Want to publicise it? 
Email us at: editor@themagpi.com 


Torbay Raspberry Jam 


When: Saturday 12th April, from 1.00pm 
Where: Paignton Library and Information Centre, Great Western Road, Paignton, TQ4 5AG, UK 


The second Torbay Raspberry Jam. Scratch, Python, Minecraft. http://dcglug.drogon.net/future-jams. 


Raspberry Pi at CERN 


When: Saturday 12th April, 9.30am to 4.30pm (Central European Time: France) 
Where: Route de Meyrin, 1211 Geneva, Switzerland 


Come and discover in the presence of experts. This workshop Is intended for children (from 6yrs), their 
parents, teachers and all interested members of the public. http://www.eventbrite.fr/e/3914624748 


PyCon 2014: Young Coders 


When: Saturday 12th - Sunday 13th April, 9.00am to 4.00pm (PDT) 
Where: Palais des congres de Montréal, 201 Viger Ave West, Montreal, Québec, Canada 


A free tutorial exploring Python games programming using simple data types, comparisons and loops in 
Pygame. http://www.eventbrite.com/e/10565294079 


Wakefield Acorn & RISC OS Computer Show 


When: Saturday 26th April, 10.30am to 4.30om 
Where: The Cedar Court Hotel, Denby Dale Road, Calder Grove, Wakefield, West Yorkshire WF4 3QZ 


The North’s Premier RISC OS Show. Now in its 19th year. A full day of theatre presentations and 
exhibitors stands. http://www.wakefieldshow.org.uk/index.php 


Raspberry Pi: Kids' "Beta" Tech Camp 


When: Sunday 27th April, 2.000m to 4.00om (EDT) 
Where: Funutation Tekademy LLC, 23715 Mercantile Road, #215 Beachwood, OH 44122 


Working in teams of two, campers will use the Raspberry Pi to do computer animations, design games, 


and make simple window applications. http://www.eventbrite.com/e/998 1423707 33 


WYLIODRIN 


Web-based programming 


Programming the Raspberry Pi from a 
web browser using a visual language 


Imagine making your own radio or creating disco 
lights using a Raspberry Pi, which you control 
from a web browser. Wyliodrin gives you this 
possibility. You can write, modify and run 
programs in real time, no matter where in the 
world your Raspberry Pi is located. 


We all face the inconvenience of building our first 
Raspberry Pi based devices - installing software 
and repeatedly plugging and unplugging the 
Raspberry Pi from the device (e.g. a remote 
controlled car) and connecting it to a screen until 
It finally does what it is Supposed to do. SSH is 
an option, but it requires firewall configuration for 
remote access. 


With Wyliodrin, you can install your Raspberry Pi 
directly onto the device you want to build and 
program it from your web browser (we 
recommend using Chrome, Firefox or Safari). 
This way, programming is possible regardless of 
the Raspberry Pi's location and without the need 
to connect to it directly. The code is stored on the 
Wyliodrin servers, So you are now able to use 
any computer to do the programming. 


Wyliodrin comes from the old Gallic words 
“wylio’ and “drin’, which summarises what the 
platform does: it monitors and handles the 
treatment/conirol of the Raspberry Pi. 


What languages can you use? 


One of our goals with Wyliodrin is to bring 
students closer to engineering; to building things. 
With the Raspberry Pi, building electronic 
gadgets has become much easier. One of the 
major problems encountered in making the 
embedded field more accessible is the popular C 
programming language. Don't get us wrong, C is 
very good for projects on microcontrollers. But 
the Raspberry Pi can accomplish more 
sophisticated tasks than a microcontroller. For 
beginners, the C language is hard to access 
online resources as they need to know about 
network sockets and low level programming. 


We think there is a need for high level languages, 
but with the power of C. With Wyliodrin, we have 
integrated the C/C++ GPIO libraries into several 
programming languages so that you are able to 
program in the language that you know. The 
available languages include Pascal, C#, 
Javascript, Python, Shell, PHP, Perl and 
Objective-C. This is very good for education as 
teaching electronics in school becomes easier. 
Students can use their favourite programming 
language to build things. 


Starting a project from scratch can be difficult. 
We always take examples and modify them in 


order to learn. Wyliodrin allows you to start a new 
project using existing examples. This way you 
can see it working and then start modifying. 


How to setup and use Wryliodrin 


Wyliodrin is currently available for the Raspberry 
Pi. It provides an online IDE, accessible from 
http://www.wyliodrin.com. All you need to do is 
sign up, download the Raspberry Pi software 
from Wyliodrin, write it to an SD card and start 
building projects. 


The Wyliodrin software on the SD card is the 
latest Raspbian Linux with Wyliodrin’s server and 
development libraries installed. You can use the 
image directly, or you can download the source 
code and build it on your own Linux distribution. 
You can find it at https://github.com/Wyliodrin. 


First, logon to the Wryliodrin website at 
htto://www.wyliodrin.com using either your 
Facebook, GitHub or Google account . 
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f Sign in with Facebook 


@® Sign in with GitHub oi Sign in with Google 


or try our demo without creating an account! 


You are presented with the Projects page, where 
you can create a new project and add the board 
you want to develop on (i.e. a Raspberry Pi). But, 
before doing that you should follow the short 
virtual tour and you can study the tutorials from 
http://projects.wyliodrin.com/wiki. 


Click on the “Add new board” button to add your 
Raspberry Pi. You need to give it a name. Next, 
you will be asked about the networking setup. In 
order to use Wyliodrin you will need to connect 
your Raspberry Pi to the internet so it can 
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connect to Wyliodrinss servers. An Ethernet 
connection is recommended. Plug in a network 
cable and it should work. If you have Wi-fi you 
will need to attach a USB Wi-fi dongle to your 
Raspberry Pi and follow configuration steps on 
the website. Wyliodrin will then display some 
instructions on how to connect your Pi. 


1. You need a 4 GB SD card. 

2. Download the Wyliodrin SD card image from 
http://projects.wyliodrin.com/images/raspberrypi. 
3. Write the image to the SD card. For Windows, 
you can use Win32Disklmager (http://source 
forge.net/projects/win32diskimager). For an 
Apple Mac computer you can use PiWriter 
(http://sourceforge.net/projects/piwriter). For 
Linux you can use the dd command. For more 
information please read our tutorial at 
https://www.wyliodrin.com/wiki/boards_setup/ras 
pberrypi. 

4. Copy the JSON configuration file to your SD 
card. This file is specific to your Raspberry Pi 
and network. It contains your Raspberry Pi 
identification and network setup. You can 
download it from your Wyliodrin account, from 
the pull-down menu for your Raspberry Pi. 
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Copy the downloaded file to the root of the SD 
card. Make sure the file is named 
wyLtodrin. json. 

5. Power up your Raspberry Pi and wait for it to 
appear online on your Wyliodrin webpage. 


Let's now make our first project using Wyliodrin. 
Blinking LED 


For the electronics setup you need the following 
basic components: 

¢ breadboard 

¢ LED 

¢ 220 resistor (or similar, e.g. 470Q) 

¢ 2x jumper wires 

¢ Raspberry Pi 


We have to wire the components, keeping in 
mind that each GPIO pin on the Raspberry Pi 
acts like a software programmed power source. 
In Wyliodrin's tutorial "Raspberry Pi Pins Layout" 
we can see how to connect the components to 
the Raspberry Pi using WiringPi pin numbering. 


The next step is to implement the project. Go to 
the Projects page and click on the “Create new 
project” button. Give it a name, a description and 
choose a programming language from Visual 
Programming, Shell script, C, C++, C#, Java, 
Javascript, Objective-C, Pascal, Perl, PHP or 
Python. 


The "main" file was implicitly created together 
with the project. There you can write the code in 
the chosen programming language and then you 


will run it on the board. For example, below we 
have the code for making a LED blink using C++. 


Dashboard main.cpp @ 


7 Keep the board with the pins and SD card facing upwards. 
8 The pin are the following: 


12 8 5 V 
13 9 GND 
14 7 15 
15 GND 16 
16 @ 1 
17 2 GND 
18 3 4 
19 3.3 V 5 
20 12 GND 
21 13 6 
22 14 18 
23 GND 11 
240 | +ea===+ 

25) */ 


27 using namespace std; 


29 // define the pin number that has the LED connected 
3@ #define LED_PIN @ 


32 int main () 
~{ 
34 cout <<"Led on pin " <<LED_PIN <<"should bLlink\n"; 


36 // Initialize the Wiring Pi Library 
37 wiringPiSetup (); 


39 // Setup the pin in output mode, so that we can write a value on it 
40 pinMode (LED_PIN, OUTPUT); 


42 cout <<"Press the Stop button to stop\n"; 
sar iimtil “wa Mracce ct+nan 
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By choosing LED Blink - (C++ when creating 
the new project, you can use the sample code 
provided by Wyliodrin. You only have to click on 
the "Run" button and choose your Raspberry Pi 
in order to make the LED blink! All this time, the 
Raspberry Pi had no connection to the computer 
we wrote the program on. 


For beginners who have not learnt a 
programming language, they can use Visual 
Programming. This lets you add blocks using 
drag-and-drop and Wvyliodrin will automatically 
write the code. Visual Programming used by 
Wyliodrin is based on Google Blockly, a 
language like Scratch but for electronics. 
Wyliodrin implemented pins, LEDs and button 
blocks, to let you run several applications. 


Below is the Visual Programming blocks needed 
to make a LED blink using the Raspberry Pi, plus 
the generated Python code. 


- ‘from wiringpi2 import * 
wiringPiSetup() 
pinMode (@, 1) 
Brut F rill 24 Led on pin 0 should blink |.) | 
| Print on screen |, = Press the Stop button to stop | | 
op mE 
Tepeat | 
60 | Set (CE9 LED onpin | 


printC'Led on pin @ should blink') 
print('Press the Stop button to stop") 
while True: 

digitalWrite (@, 1) 

delay (50@) 

digitalWrite (@, @) 

delay (50@) 


E7500} miliseconds ~ 
(Re SE ETS — 
| Set (E93 LED on pin iO) 


Music and an LCD 


Our next Wyliodrin project shows you how to 
build an internet radio complete with an LCD. We 
will use the LCD to display a VU meter plus the 
name of the song that is currently playing. For the 
electronics setup you need the _ following 
components: 


¢ breadboard 

¢ 16x2 LCD screen (other sizes can be used) 
¢ 10kQ potentiometer 

¢ 14x jumper wires 

¢ Raspberry Pi 


The wiring diagram is shown below. 
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Video-Out Audio 


Wiring up the LCD can be done in two ways; we 
will use the one that requires the least number of 
wires. You have to connect power to the LCD. 
Please be careful. The pin layout of the LCD may 
vary from model to model, so take a look at its 
data sheet. Our LCD is a 5V one with 16 columns 
and 2 rows. Its data sheet can be found at 
http://robofun.ro/docs/RC1602B-BIW-CSX.pdf 
Connect the ground pin (V..) to the ground of the 
Raspberry Pi and the 5V pin (V,,) to the 5V pin 
on the Raspberry Pi. The VO pin on the LCD is 
used to set up the contrast, so connect it to the 
wiper of the 10kQ potentiometer. Also wire the 
backlight pins (LED - and LED +) to the ground 
pin and 5V pin on the Raspberry Pi. 


You also need to connect the RS, E, DB4, DBS, 
DB6 and DB7 pins to the Raspberry Pi. You can 


connect them to any of the Raspberry Pi GPIO 
data pins. The R/W pin ts connected to ground 
as we will only write data to the LCD. 


Let's make a new project and write the software. 
Click on the "Create new project" button and 
choose Music - Visual Programming, so that 
you can drag and drop blocks and Wyliodrin will 
write the Python code for you. This way you have 
the music player set up. Once you have created 
the project, click it to edit it. 
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As you can see above, you already have the 
blocks for playing music from an online radio 
station. The default station does not show the 
title of the song, so please change it to another. 
Click on the block “Load audio stream from” and 
enter another address. [Ed: See The MagPi 
issue 21, page 24 for some examples, e.g. 
http://oub6.sky.fm:80/sky_tophits.] Let’s test if it 
plays. Click on the "Run" button and don't forget 
to connect a speaker to your Raspberry Pi. 


Now let's modify the program so that it displays 
the song title and then shows a VU meter. First, 
you need to initialise the LCD. Go to the LCD 
blocks on the left toolbar and drag the "Init LCD" 
block and place it between the "Play audio 
stream" and "repeat" blocks. You will see you 
need to set the LCD pin numbers. For our LCD, 
the pins are RS = 0, E = 2, Datal = 3, Data2 = 
12, Data3 = 13 and Data4 = 14. They are the 
same as in the wiring diagram. Another 
parameter is the number of columns and rows. 
Our LCD is 16 columns and 2 rows. 


Let's display the internet radio — station 
information. Inside the "repeat" block, after the 
"delay" block, put a "Reset Position on LCD" 
block. The LCD works like a normal screen: once 
you write to it, it moves the cursor ahead. As we 
want to display the name at the beginning, you 
need to add a "Reset Position on LCD" block. 
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After this, place a "Print on LCD block". Inside 
this block, replace the text block with the "Audio 
stream Address Title" block, which Is found in the 
Multimedia blocks on the left toolbar. This block 
receives a parameter with the variable of the 
stream. By default, this is called audio. Change 
it to music (the same variable used for the other 
Multimedia blocks). 


Click the "Run" button and you should see the 
station name or song title (depending on what the 
Station broadcasts) on the LCD. Some stations 
do not provide this information so don’t worry if 
nothing is written. 


The VU meter is a measure of how loud the 
music is. We want to display this in the form of * 
(asterisks) on the LCD. For this, you need to use 
the "Stream level" block from the Multimedia 
blocks. First, set a variable called L to the value 
returned by the "Stream level" block. To do this, 
drag the "Set variable to" block from Variables 
and place it after the "Print on LCD" block. 
Create a new variable called 1. Connect to this 
block the "Stream level" block. Select the music 
stream and set the scale to 10. The scaling will 
tell the block to return a value between 0 and 10. 


Next we need to display the asterisks. Set the 
LCD position to the beginning of the second row 
Place the "Set LCD Position" block before the 
"Set variable to" block and set the row to 2. From 
the Loops blocks add a "count with" block and 
set its variable to 1 and make it count from 1 to 
10 by 1. This means that the content of this block 
will be repeated for every value of 1 from 1 to 10. 


Inside this block we display on the LCD either a * 
or a space using the following rule. If the variable 
L (which stores the current level) is less than 1, 
then we display a * otherwise we display a 
space. For this we use a Logic block called "if". 
Drag an "if" block inside the "count with" block. 
The "if" block has a star on it. If you click it, a 
small window will appear and we can set up the 
block. We need to drag an "else" block inside the 
"if" block. Once you have done this, you are 
ready to write on the screen. Connect to the "if" 
block the "less or equal" Logic block. The 


condition we want is 1 <= 1. We need to drag in 
the 1 and 1 blocks from the Variables block. 


The "if" block has two parts: "do" and "else". The 
"do" part will be executed if the condition is true 
or the "else" part will be executed if the condition 
is false. In the "do" part, place a "Print on LCD" 
block with the text *. On the "else" part, place a 
"Print on LCD" block with a space. 


Before you run the program, change the "delay" 
block to 100 milliseconds for a faster update of 
the VU meter. The final npHOghani is enewn below. 
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Future perspectives 


We are working on implementing graphics, which 
will allow users to monitor their Raspberry Pi in 
real-time. We also plan on introducing more 
blocks for the Visual Programming language. We 
would like to ask you to provide feedback. This is 
very important for us. If you would like new 
features or think that we should do something 
differently, please don't hesitate to contact us. 


You can read more about the project at 
htto://www.wyliodrin.com, on the Wyliodrin 
Facebook and Google+ pages and also on 
Twitter @wyliodrin. 
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FEATURES OF THE LAIKA EXPLORER BOARD: 
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SKILL LEVEL : ADVANCED 


Scratch is a very useful programming language that children and students can pick up quickly. However, one 
feature lacking from the current version of Scratch is Input/Output (I/O) support. Thankfully, Scratch supports 
network messages that can be exchanged with local or remote devices. The RpiScratchlO package, which was 
intoduced in Issue 20 of The MagPi, was written to provide a general protocol for I/O devices and minimise the 
overhead of adding new devices to Scratch. This package uses the network broadcast message system in 
Scratch, via the scratchpy Python library. The RpiScratchlO package implements a general protocol that can be 
used to connect any I/O device to Scratch. Additional documentation for RpiScratchlO can be found at : 
httos://pypi.python.org/pypi/RpiScratchlO/ 

The purpose of this article is to demonstrate how to add a user defined I/O device to Scratch using RpiScratchlO. 


Installing RpiScratchlO 


This article requires RpiScratchlO version 0.1.5 or greater. If RpiScratchlO has not already been installed, then 
follow the instructions in Issue 20 of The MagPi to install the package. If RpiScratchlO is already present then 
update the package by typing: 


sudo pip install RpiScratchIO --upgrade 


I/O devices in RpiScratchlO 


An I/O device is anything that reads or writes data. This could be a LINUX command or an expansion board. 
RpiScratchlO expects that an I/O device has a list of input and output channels associated with it. For simple 
devices, this could imply one output channel only. The channels on the device do not have to be numbered 
sequentially, to allow for physical pin numbering or another non-sequential system. A channel can function as an 
input or as an output device or both. 


Each I/O device is described by a simple Python class that has to implement a constructor and can optionally 


implement config, read and write member functions. When config, read or write commands are sent from 
Scratch, the RpiScratchlO package calls the config, read or write functions of the associated I/O device. If 
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one of these functions has not been implemented and it is called by Scratch, then a warning message is printed 
to warn the user that the function has not been implemented. 


Setting the PYTHONPATH 


For a user defined Python class to be included in RpiScratchlO, it should be saved in a file that is within a 
directory that is in the PYTHONPATH. The PYTHONPATH is an environmental variable that can be set in the same 
way as any other Bash environmental variable, 


export PY THONPATH=$HOME/user-devices 


Rather than risk overwriting previous configuration or continuously appending to the PYTHONPATH, a little more 
Bash can be used: 


user_devices=$HOME"/user-devices" 
if [LE -z $PYTHONPATH ]]; then 
export PYTHONPATH=$user_devices 
elif [[ $PYTHONPATH != *"$user_devices"* ]]; then 
export PYTHONPATH="$PYTHONPATH: $user_devices" 
Fi 
unset user_devices 


Similar to the PATH variable, the format is that multiple directories are separated by colons. In this example, the 
$HOME/user-devices directory is where the Python files that contain the user defined devices are stored. 
This script could be added to the end of the ~/. bashrc file or sourced beforehand. 


Adding an I/O device 


Create a BasicDevice. py file in the $HOME/user-devices directory. Then append to this file, 


import RoiScratchI0O 
from RpiScratchI0O.Devices import GenericDevice 


class BasicDeviceCGener1icDevice): 
def __init__Cself,deviceName_,scratchIO_,connections_): 


# Call the base class constructor 
super(BasicDevice, self).__1nit__CdeviceName_,scratchIO_,connecttions_) 


# This device has a single input channel 
self.inputChannels += [@] 


# Add other code here 1f needed... 


This represents a device that has one input channel. All device classes must inherit from the GenericDevice 
class in the RpiScratchlO package, either directly or via one of the other base classes. The constructor of the 
class must contain the four default arguments, the device name, the pointer to the ScratchIl0O object and a list 
of connections associated with the device. Other arguments can be passed to the constructor after the default 
arguments. The other thing to note about this constructor is that the single input channel number is appended to 
the self.tnputChannels list. This list and the self.outputChannel list are defined in the 
GenericDevice base class. Therefore the derived class should append to the lists. To use the example 
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BasicDevice class in RpiScratchlO, create a test. cfg configuration file that contains: 


[DeviceTypes | 


test = from BasicDevice import BasicDevice; BasicDeviceC) 


[DeviceConnections | 
test = something 


The user defined device class is imported, instantiated and associated with the name test. The default 
arguments are automatically passed to the constructor of the BasicDevice class. Since the device connections 
are not used in the example device class, any dummy value can be assigned to test. To use this class, create a 
Scratch program that broadcasts config, read and write messages: 


woe | key pressed 
brosdcast. las liread 


stop script 


wer vi Key Dressed 
briadcast testiwriterl 


‘stop script 


when <<. key pressed 
broadcast test:configiargl.arg?e 


Stop script 


whem ¥' Key pressed 


— 


say | join fe test [sensor value for §§ secs 


stop script 


Pinging a computer 


Then enable the remote sensor connections, by right 
clicking on the "sensor value" text at the bottom of the 
"Sensing" tool palette. (When the current Raspbian 
version of Scratch starts, remote sensor connections are 
not enabled. To enable them, disable and then re-enable 
them. Refer to the article in Issue 20 for more information.) 
Now start RpiScratchlO, using the configuration file. 


RpiScratchlI0O test.cfg 


Then write a program to test the test sensor value and 
send read, write and config commands. In this example, 
the sensor value from the device will always be zero. 
Calling the read, write and conf1g functions will cause 
warning messages to be printed on the screen. These 
warning messages are printed by the base class versions 
of the config, read, and write functions. These functions 
can be overridden be implementing functions with the 
same input arguments as those given in Gener1icDevice. 


The ping command was discussed in Issue 21 of The MagPi. ping can be used as an I/O device with one 
input channel, where the input channel is a selected result from the ping command. The steps to create a 
device class that uses a p1ng command are the same as for the previous example. First, create a file called 
PingHost. py in the $HOME/user-devices directory, 


import subprocess, string 
import RoiScratchI0O 


from RpiScratchI0.Devices import GenericDevice 


class Ping(GenericDevice): 


def __init__Cself ,deviceName_,rpiScratchI0_,connections_): 


# Call the base class constructor 


Super(Ping, self).__1nit__CdeviceName_,rpiScratchI0_,connections_) 


# This device has a single input channel 
self.inputChannels += [Q@] 


# The default host, in case no host 1s configured 
self.hostname = "LocaLhost" 


def config(self,argList): 
nargs = LenCargList) 
if Maggs. ——.0: 
printC"WARNING: \"config\" in device %s expects at least one argument." % self.deviceName) 
return None 


# Set new host name to ping 
self.hostname = argList[Q] 


def read(Cself,channelNumber): 


# Setup the ping command to run once 
ping = subprocess. Popen( 
L"ping", "-c", "1", self.hostname], 
stdout = subprocess.PIPE, 
stderr = subprocess.PIPE 


) 


# Set the default value to indicate something went wrong 
avgRoundTrip = -999 


# Run the ping command 
out, error = ping.communicate() 


# Parse the standard out and error 


if string.findCerror, ‘unknown host') != -1: # LINUX specific 
avgRoundTrip = -2 

elif string.findCout, '100% packet loss") != -1: # LINUX specific 
avgRoundTrip = -1 

else: 


for line in StringssplitCout,  \n-): 
# This search string 1s Linux specific 


if string.findCLine, 'rtt min/avg/max/mdev') == -1: 
continue 
PeAGS = —(SthingesplitChine.: <=. 3) 


if lenCfrags) != 2: 
print "WARNING: badly formatted string" 
continue 

values = “string .splitCiragsilil, 7) 

1f LenCvaLlues) < 2: 
print "WARNING: badly formatted values string" 
continue 

avgRoundTrip = floatCvaLues[2]) 


# Send the value back to Scratch 
self .updateSensorCchanneLNumber , avgRoundTrip) 


# Since there might be a significant delay, send Scratch a trigger message. 
self .broadcastTriggerCchannelNumber ) 


The next step is to create a configuration file to associate the class with Scratch. Then launch RpiScratchlO, to 
read the new configuration file. Once RpiScratchlO is running, the ping sensor will be available in Scratch. 


[DeviceTypes | 


> ace. | key pressed ping = from PingHost import Ping; Ping C) 


switch to costume Ping | [DeviceConnections] 


= a —————— ——a 


‘beGadesct pino:read- ping = localhost 
wait Pa secs ; ; 
a a In the configuration file, the connection passed to the Ping class 

asi = ' ‘ 
penton her Coe nis: Se is the default computer to ping. 


stan. script 


when I-receive Ping-trig 


say PING. | sensor value for Secs = —— 


stop script 


In the example Scratch program, a sprite with two costumes was 


when 0° | key pressed created, where one of these costumes was named ping and 
beoadcast ping:config:badhost | the other was named 1tdle. Then broadcast commands were 
= en added to test each of the functions and the response of the Ping 
ston =Criot 

device. 
when || key pressed Try pressing the spacebar. If the b key is pressed, then a 


badhost name is used. This will produce a sensor error value 

of -2. In the case of this example program, the 192.168.2.1 

address was a router that was firewalled. This caused a sensor 

error value of -1. In the case of the LocaLhost, the round trip 

when 1.) hey pressed time reported by ping is quite quick. Try swapping the IP 
addresses for some other machine on the network. 


broadcast ping: configttocaihast 


stop script 


beosdeast Ping config: 192,1668;2.1 


ston script y ; , : . ‘ 
abide When the ping command runs it waits until a reply is received or 


it reaches the timeout value. This means that ping can be a bit 
slow to respond, if it takes a long time for the network packet to return. Rather than polling the output of the ping 
command, the Ping device sends a trig message back to Scratch to indicate a new sensor value is available. 
This means that Scratch is idle until ping has finished. 


Next time 
The next tutorial will include some examples of writing output results and interfacing with hardware devices. Until 


then, try inheriting from the So1Device base class and connect to an SPI device. There is an example of how to 
do this in the So1Devices. py file in the RpiScratchlO package. 
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APRIL COMPETITION 


Once again The MagPi and PC Supplies Limited are proud to announce yet 
another chance to win some fantastic Raspberry Pi goodies! 


This month there are THREE prizes! 


Each of the three winners will receive a een. < 
Gerboard mount and a 32GB SDHC Memory eee as 
card. The prefect accessories for a serious a" 
Raspberry Pi project. 


For a chance to win this month's competition 
visit http://‘www.pcslshop.com/info/magpi 


Closing date is 20th April 2014. 
Winners will be notified in the next issue. 


To see the large range of PCSL brand Raspberry Pi accessories visit 
http://www.pcslishop.com 


Marchs Winner! 


The first prize winner of a Pi NolR camera board, 32GB SD card, VESA mount case and a 
gigabit network hub! Scott Lindsay (East Kilbride, Scotland) 

The second prize winner of a Cyntech Geek case, GPIO breakout board, breakout cable set 
and a 16GB SD card! Lee Murphy (Wakefield, England). 


Congratulations. We will be emailing you soon with details of how to claim your prizes! 


Raspberry Pi User Guide (2nd Edition) 
Eben Upton and Gareth Halfacree 


The Raspberry Pi has 
been a_ success 
beyond the dreams of 
its creators. Their 
goal, to encourage a 
new generation § of 


: computer 
Raspberry Pi programmers — who 
User Guide 
understand how 


computers work, is 
well under way. 


Eben Upton 


Gareth Halfacree 


Raspberry Pi User Guide 2nd Edition is the 
newest edition of the runaway bestseller written 


by the Raspberry Pi's co-creator, Eben Upton, 
and tech writer Gareth Halfacree. It contains 
everything you need to know to get the 
Raspberry Pi up and running, including how to 
connect up a keyboard, mouse and other 
peripherals, installing software, basic 
configuration and Linux system administration, 
using the Raspberry Pi as a web server or media 
centre, learning programming languages Scratch 
and Python and, of course, how to use the GPIO 
pins to interface with electronics projects. 


Unlike the previous edition, this book now 
includes coverage of the Camera Board, the 
introduction of the Pi Store, NOOBS and much 
more. Raspberry Pi User Guide 2nd Edition is 
the perfect companion for getting the most out of 
the computing phenomenon that is_ the 
Raspberry Pi. 


MagPi readers are able to receive a 30% discount off the RRP. To claim, purchase 


from www.wiley.com and enter the promo code VBHO2 when prompted. 
Please note: this discount is only valid from the 1st April to the 31st May 2014 on the two book titles listed here. 


Learning Python with Raspberry Pi 
Alex Bradbury and Ben Everard 
Wiley 


Python is one of the world's top programming 
languages. In addition to being used by the likes 
of Google, Spotify, YouTube and the BBC, it is 
also the language of choice for the Raspberry Pi. 


Co-authored by one of the lead software 
developers for the Raspberry Pi Foundation, 
Learning Python with Raspberry Pi is the must- 
have companion to the Raspberry Pi User Guide 
(above) and an indespensible resource for 
anyone wishing to learn how to program on the 
Raspberry Pi. 


Assuming no prior programming experience 
whatsoever, it covers all of the bases for novice 
programmers and first-time Python developers. 
Following a brief introduction to programming 
and coding in general and Python in particular, 
authors Alex Bradbury and Ben Everard cut to 


the chase with clear, step-by-step guidance on 
configuring and getting started, using variable, 
loops and functions, learning 3D graphics 
programming, using PyGame, programming 
Minecraft, and » = 
using the | 
GPIO port. 


Featuring eee be 
easy-to-follow | @ ; 
hands-on 
instruction and 
packed ~—_ with 
working | 
examples and 
useable source é 
code, Learning 
Python with 
Raspberry Pi 
gets you up 

and running with the knowledge and skills you 
need to write your own programs in Python. 


Learning Python’ 
with Raspberry Pi 


Alex Bradbury 


and Ben Everard 
WILEY 
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Feedback & Question Time 


| just wanted to let you Know 
that | really enjoyed Martin 
Hodgson’s Python port of 
Strongholds of the Dwarven 
Lords that was in the recent 
issue of The MagPi. | plan 
on sharing it with some of 
my more advanced gifted 
middie school students. 
Please continue to include 
Python programs like this in 
your magazine. It’s nice to 
be able to do cool things 
with the Raspberry’ Pi 
without needing to purchase 
hardware or having the 
needed knowledge to make 
it work. | hope to see more 
of Martin's submissions in 
future issues! 
Thanks! 
Jason Kibbe 
CAMS North & South Gifted 
Support 


After taking the plunge and 
purchasing my very first 
Raspberry Pi, | stumbled 
upon your great magazine, 
As a complete novice to the 
world of the Raspberry Pi, 
The MagPi magazine is an 
excellent resource. The 
variety of articles, guides 
and project ideas are an 
inspiration; there is_ really 
something for everyone! 
Many thanks, 
Caron Jones 


lf you are interested in 
writing for The MagPi, 
would like to request an 
article or would like to join 
the team involved in the 
production, please get in 
touch by emailing the editor 
at: 
editor@themagpi.com 


